AI Gateway Client macOS Apple Silicon 使用说明

适用系统：
- macOS 12 或更新版本
- Apple Silicon 芯片：M1、M2、M3、M4

推荐打开方式：
1. 解压本压缩包。
2. 双击 AI Gateway Client.app。
3. 如果系统提示无法验证开发者，按住 Control 点击应用，选择“打开”。
4. 输入运营方发放的激活码。
5. 激活成功后进入工具工作台，但不会一次性安装全部智能体。
6. 点击 Codex 的“安装”，客户端会自动下载 OpenAI 官方 DMG、验证签名和架构、安装、写入网关配置并打开。
7. 其它工具在可信安装源发布前会显示“暂未发布”，不会执行未经校验的远程命令。

如果双击没有反应：
1. 双击“Open AI Gateway Client.command”。
2. 如果 macOS 提示权限问题，打开终端执行：
   chmod +x "Open AI Gateway Client.command"
3. 再次双击该 command 文件。

排查顺序：
1. 点击应用里的“预检”，确认系统架构、Codex CLI、Codex Desktop 和路径状态。
2. 点击“超级说明书”，按用户激活、智能体使用顺序、其它智能体说明逐步检查。
3. 把日志窗口里的错误文本发给管理员。

文件校验：
- 管理员可用同目录的 `.sha256` 文件核对压缩包是否被替换。
- 发布登记时优先登记 ZIP，并保存 SHA-256。

安全说明：
- 完整 token 只写入本机配置文件，界面只显示 token 前缀。
- 客户端不会静默覆盖非 AI Gateway 管理的 Codex 配置。
- Codex 安装包必须通过 OpenAI 发布团队签名、Apple 公证和 Apple Silicon 架构检查。
- 服务端不能下发任意 shell 命令，客户端只执行内置白名单安装器。
- 其它智能体当前写入 ~/.ai-gateway/tools/<tool> 下的独立配置包，后续按具体工具版本再接入专用适配器。
